Xbasic

TOP_RECORDS_PCT_LIST Function

Syntax

Record_List as C = top_records_pct_list(C order ,N percent [,C filter])

Arguments

order

Optional. Default = "" (record number order). A character order expression that sorts selected records.

percent

A number from 0 to 100, representing the percentage of the table's records to retrieve. Numeric

filter

Optional. Default = ".T." (All records). A character filter expression that evaluates to a logical value and selects records from the table.

Returns

Record_ListCharacter

A list of the record numbers from the current table.

Description

Returns the specified top percent of records from a DBF table matching the specified filter and order expression.

Discussion

The TOP_RECORDS_PCT_LIST() function returns a list of the record numbers from the current table of the first percent records as defined the Order_Expn and Filter_Expn arguments. This function should be run from an open layout.

put description here

dim frm as P
frm = form.view("Customer Information")
? top_records_pct_list("lastname", 25)
= "32 56 55 52 54 18 48 8 51 20 30 39 34 10 5 "

See Also